今天開始要來詳細介紹Laravel能做到的各種功能。
首先,從資料庫建置開始
遷移是一種資料庫的版本控制,讓團隊能夠輕鬆的修改跟共享應用程式的資料庫結構。遷移通常會搭配 Laravel 的結構建構器,讓你可以輕鬆的建構應用程式的資料庫結構。
可以使用 make:migration
Artisan 指令 建立遷移:
php artisan make:migration create_users_table
新的遷移檔將會放置在 database/migrations
目錄中。每個遷移檔名稱都包含了一個時間戳記,讓 Laravel 能夠確認遷移的順序。
--table
和 --create
選項可用來指定資料表的名稱,或是該遷移會建立新的資料表。這些選項只需預先在產生遷移建置檔案時填入指定的資料表:
php artisan make:migration add_votes_to_users_table --table=users
php artisan make:migration create_users_table --create=users
如果你想為產生的遷移指定一個自定的輸出路徑,你可以在執行 make:migration
指令時使用 --path
選項。提供的路徑必須相對於你應用程式的基本路徑。
一個遷移類別會包含兩個方法:up
和 down
。up
方法用於在資料庫內增加新的資料表、欄位、或索引,而 down
方法則必須簡單的反向執行 up
方法的操作,這兩個方法中你可以使用 Laravel Schema建構器明確的建立及修改資料表。例如:
<?php
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;
class CreateFlightsTable extends Migration
{
/**
* 執行遷移。
*
* @return void
*/
public function up()
{
Schema::create('flights', function (Blueprint $table) {
$table->increments('id');
$table->string('name');
$table->string('airline');
$table->timestamps();
});
}
/**
* 還原遷移。
*
* @return void
*/
public function down()
{
Schema::drop('flights');
}
}
要執行你應用程式中所有未完成的遷移,可以使用 migrate
Artisan 指令。如果是使用 Homestead 虛擬主機,則要在虛擬機器中執行下方的指令:
php artisan migrate
如果在你執行時出現「class not found」的錯誤,請試著在執行 composer dump-autoload
指令後再次執行一次遷移指令。
一些遷移的操作是有破壞性的,意思是它們可能會導致你失去資料。為了保護你上線環境的資料庫,在這些指令被執行之前,系統將會提示你進行確認。若要忽略提示強制執行指令,你可以使用 --force
:
php artisan migrate --force
若要還原遷移至上一個「操作」,你可以使用 rollback
指令。請注意,此還原是回復到上一次執行的「批量」遷移,其中可能包括多筆的遷移檔案:
php artisan migrate:rollback
migrate:reset
指令會還原應用程式的所有遷移:
php artisan migrate:reset
migrate:refresh
指令首先會還原你資料庫的所有遷移,接著再執行 migrate
指令。此指令能有效的重新建立整個資料庫:
php artisan migrate:refresh
php artisan migrate:refresh --seed
*註:執行--seed
可以在資料庫中填入假資料
要建立一張新的資料表,可以使用 Schema
facade 的 create
方法。create
方法接收兩個參數。第一個參數為資料表的名稱,第二個參數為一個閉包,它接收一個用於定義新資料表的 Blueprint
物件:
public function up(){
Schema::create('users', function (Blueprint $table) {
$table->increments('id');
});
}
您可以使用 hasTable
和 hasColumn
方法簡單的檢查資料表或欄位是否存在:
if (Schema::hasTable('users')) {
//
}
if (Schema::hasColumn('users', 'email')) {
//
}
如果你想要在一個非預設的資料庫連接進行結構操作,可以使用 connection
方法:
Schema::connection('foo')->create('users', function (Blueprint $table) {
$table->increments('id');
});
若要設置資料表的儲存引擎,只要在Schema建構器上設置 engine
屬性:
Schema::create('users', function (Blueprint $table) {
$table->engine = 'InnoDB';
$table->increments('id');
});
若要重新命名一張已存在的資料表,可以使用 rename
方法:
Schema::rename($from, $to);
要刪除已存在的資料表,你可使用 drop
或 dropIfExists
方法:
Schema::drop('users');
Schema::dropIfExists('users');
若要更新一張已存在的資料表,我們會使用 Schema
facade 的 table
方法。如同 create
方法,table
方法接收兩個參數:資料表的名稱,及一個接收 Blueprint
實例的閉包,我們可以使用它為資料表增加欄位:
Schema::table('users', function (Blueprint $table) {
$table->string('email');
});
在官方文件中還有其他的欄位建立指引。
除了文件列出的欄位類型之外,這有還有一些欄位「修飾」可用於新增欄位到資料表。例如,你可以使用 nullable 方法來使欄位為「nullable」:
Schema::table('users', function (Blueprint $table) {
$table->string('email')->nullable();
});
在官方文件中還有其他的欄位修飾指引。
Laravel 也為建立外鍵約束提供支援,這是用於在資料庫層面強制參考完整性。例如,讓我們定義 posts 資料表內有個 user_id 欄位要參考至 users 資料表的 id 欄位:
Schema::table('posts', function (Blueprint $table) {
$table->integer('user_id')->unsigned();
$table->foreign('user_id')->references('id')->on('users');
});
要移除外鍵,你可以使用 dropForeign
方法。外鍵約束與索引採用相同的命名方式。所以,我們可以連結資料表明與約束的欄位,接著在該名稱加上「_foreign」後綴:
$table->dropForeign('posts_user_id_foreign');
可以在你的遷移中使用下列方法來啟用或停用外鍵約束:
Schema::enableForeignKeyConstraints();
Schema::disableForeignKeyConstraints();